home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Developer Essentials / DTS Sample Code / Macintosh Sample Code / SCN (MPW) / SCN.011.GetZoneList < prev    next >
Encoding:
Text File  |  1990-05-01  |  2.5 KB  |  55 lines  |  [TEXT/MPS ]
  1. Macintosh
  2. Sample Code Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. #11:    GetZoneList
  7.  
  8. Written by:    Mark Bennett & Pete Helme
  9.  
  10. Versions:           1.0                           November 1988
  11.                     1.1                           October 1989
  12.                     1.2                           May 1990
  13.  
  14. Components:         GetZoneList.c                 May 1, 1990
  15.                     GetZoneList.p                 May 1, 1990
  16.                     GetZoneList.r                 May 1, 1990
  17.                     Makefile                      May 1, 1990
  18.  
  19. Required:           UFailure.a                    November 1, 1988
  20.                     UFailure.h                    November 1, 1988
  21.                     UFailure.incl.p               November 1, 1988
  22.                     UFailure.p                    November 1, 1988
  23. _____________________________________________________________________________
  24.  
  25. This program needs MPW 3.0 or greater to build. It also requires that you
  26. copy the necessary files from the UFailure UNIT (originally distributed as
  27. part of SC.012.Signals) to the GetZoneList folder.
  28. _____________________________________________________________________________
  29.  
  30. GetZoneList is a sample application that uses AppleTalk's AppleTalk
  31. Transaction Protocol (ATP) and Zone Information Protocol (ZIP) to obtain a
  32. list of zones on an AppleTalk internet.  It also demonstrates using a signal,
  33. or failure-catching mechanism, to recover from error situations.
  34.  
  35. GetZoneList is based on Sample, and DTS recommends that you review Sample or
  36. TESample for the general structure and MultiFinder techniques you should use
  37. when writing a new application.
  38.  
  39. Changes for Version 1.2
  40. _______________________
  41.  
  42. A node exists on a valid internet if, and only if, 1) GetBridgeAddress
  43. returns a non-zero router address and 2) GetNodeAddress returns a non-zero
  44. network number.  If there is a valid network number, but no router, one
  45. cannot obtain zone information, and there cannot be a internet.  The
  46. previous version of GetZoneList only checked GetNodeAddress, which could
  47. show a non-zero network number in the presence of a half router.  This
  48. current version now makes the appropriate check in the procedure
  49. BuildZoneList.
  50.  
  51. Changes were also made to support AppleTalk Phase 2 in accordance with
  52. Technical Note #250, "AppleTalk Phase 2 on the Macintosh."  See procedures
  53. ZoneListCleanUpPhase2 and BuildZoneListPhase2.
  54.  
  55.